Graphics Data Management12

This section describes functions for managing graphics data. These functions apply to all derived media handler components.

MediaGetDrawingRgn

The MediaGetDrawingRgn function allows your derived media handler component to specify a portion of the screen that must be redrawn. This region is defined in the movie's display coordinate system.



 
pascal ComponentResult MediaGetDrawingRgn (MediaHandler mh, 

                     RgnHandle *partialRgn);

mh: Identifies the Movie Toolbox's connection to your derived media handler.
partialRgn: Points to a handle that defines the screen region to be redrawn. Note that your component is responsible for disposing of this region once drawing is complete. Since the base media handler will use this region during redrawing, it is best to dispose of it when your component is closed.

DISCUSSION

The Movie Toolbox calls this function in order to determine what part of the screen needs to be redrawn. By default, the Movie Toolbox redraws the entire region that belongs to your component. If your component determines that only a portion of the screen has changed, and has indicated this to the Movie Toolbox by setting the mPartialDraw flag to 1 in the flagsOut parameter of the MediaIdle function, the Movie Toolbox calls your component's MediaGetDrawingRgn function. Your component returns a region that defines the changed portion of the track's display region.

RESULT CODES



 

badComponentSelector

0x80008002

Function not supported

Memory Manager errors

MediaGetGraphicsMode

The MediaGetGraphicsMode function allows you to obtain the graphics mode and blend color values currently in use by any media handler.



 
pascal ComponentResult MediaGetGraphicsMode (

                     MediaHandler mh,

                     long *mode,

                     RGBColor *opColor);

mh: Identifies the Movie Toolbox's connection to your derived media handler.
mode: Contains a pointer to a long integer. The media handler returns the graphics mode currently in use by the media handler. This is a QuickDraw transfer mode value.
opColor: Contains a pointer to an RGB color structure. The Movie Toolbox returns the color currently in use by the media handler. This is the blend value for blends and the transparent color for transparent operations. The Movie Toolbox supplies this value to QuickDraw when you draw in addPin , subPin , blend , transparent , or graphicsModeStraightAlphaBlend mode.

RESULT CODES

Component Manager errors, as documented in Inside Macintosh: More Macintosh Toolbox .

MediaSetGraphicsMode

The MediaSetGraphicsMode function allows you to set the graphics mode and blend color of any media handler.



 
pascal ComponentResult MediaSetGraphicsMode (

                     MediaHandler mh,

                     long mode,

                     const RGBColor *opColor);

mh: Identifies the Movie Toolbox's connection to your derived media handler.
mode: Specifies the graphics mode of the media handler. This is a QuickDraw transfer mode value.
opColor: Contains a pointer to the color for use in blending and transparent operations. The media handler passes this color to QuickDraw as appropriate when you draw in addPin , subPin , blend , transparent , or graphicsModeStraightAlphaBlend mode.

RESULT CODES

Component Manager errors, as documented in Inside Macintosh: More Macintosh Toolbox .

Graphics Data Management

MediaGetDrawingRgn

DISCUSSION

RESULT CODES

MediaGetGraphicsMode

RESULT CODES

SEE ALSO

MediaSetGraphicsMode

RESULT CODES

SEE ALSO